home *** CD-ROM | disk | FTP | other *** search
/ Reverse Code Engineering RCE CD +sandman 2000 / ReverseCodeEngineeringRceCdsandman2000.iso / RCE / Library / +ORC / Orc pac 9A / FILEZ.ZIP / SICE3'95.ZIP / setup.Z / UTIL16.TXT < prev    next >
Encoding:
Text File  |  1996-11-26  |  4.0 KB  |  111 lines
  1.  
  2. UTIL16.TXT
  3.  
  4. Using the Utilities in UTIL16 with SoftICE 3.0
  5.  
  6.  
  7. -----------------------------------------------------------------
  8.                         Table Of Contents 
  9. -----------------------------------------------------------------
  10. * What's in UTIL16
  11. * Debugging 16-bit DOS Programs
  12. * Debugging 16-bit Borland Windows Programs
  13. * UTIL16 Command Syntax
  14.  
  15.  
  16. What's in UTIL16
  17. ----------------
  18.  
  19.  
  20. SoftICE 3.0 replaces all the separate utilities you needed in prior 
  21. versions for Windows NT and Windows 95 with an integrated symbol loader 
  22. (LOADER32.EXE) and a utility for batch loading (NMSYM.EXE). They create 
  23. and load a new symbol file format (.NMS) that contains type information 
  24. and supports local data and structures. LOADER32 and NMSYM support 32-
  25. bit Windows programs in a variety of debug formats, and 16-bit Windows 
  26. programs in CodeView debug format. They can load .SYM files, but you 
  27. will not have access to locals and structures.
  28.  
  29. UTIL16 contains the utilities you use to load DOS programs and 16-bit 
  30. Windows programs in Borland debug format. You won't need these utilities 
  31. for debugging most other programs. However, if you build your module 
  32. with debug formats that LOADER32 can't translate into a .NMS symbol 
  33. file, you may be able to use the utilities in UTIL16 to create a .SYM 
  34. file that LOADER32 can load.
  35.  
  36. UTIL16 includes these programs:
  37.  
  38. MSYM.EXE - converts a .MAP file to a .SYM file
  39. DLDR.EXE - loads DOS programs, symbols and source into SoftICE
  40. WLDR.EXE - loads Windows programs, symbols and source into SoftICE
  41.  
  42.  
  43. * Debugging 16-bit DOS Programs
  44. -------------------------------
  45.  
  46. SoftICE reads symbolic information directly from a 16-bit DOS .EXE file 
  47. that is built with debug information in CodeView or Borland format. For 
  48. .COM files, SoftICE reads debug information only from a .SYM file.  To 
  49. create a .SYM file, you need to extract public symbol and line number 
  50. information from the .MAP file. Add the appropriate linker switch to 
  51. generate a .MAP file, then run the MSYM.EXE utility to generate a .SYM 
  52. file.
  53.  
  54. To generate CodeView debug information:
  55. MASM 6.11                   compile: /Zi   link: /CO
  56. Microsoft Visual C++ 1.52   compile: /Z7   link: /CO
  57. Watcom C++ 10.5             compile: -hc -d3
  58.                             link: DEBUG CODEVIEW OPTION CVPACK
  59. Symantec C++ 7.2            compile: -g    link: /CO
  60.  
  61. To generate Borland debug information:
  62. Borland C++ 4.5             compile: /v    link: /v 
  63.  
  64. Use DLDR.EXE to load your program. The file extension (or lack of 
  65. extension) you pass to DLDR determines what program elements get loaded:
  66.  
  67. DLDR myfile (no extension, loads executable, symbols and source)
  68. DLDR myfile.sym (loads symbols and source, but not the executable)
  69. DLDR myfile.exe (loads the executable, but no symbols or source)
  70.  
  71.  
  72. Debugging 16-bit Borland Windows Programs
  73. -----------------------------------------
  74.  
  75. 1) Compile and link your program with debug information.
  76.  
  77. 2) Load your program with WLDR.EXE.
  78.  
  79.  
  80. UTIL16 Command Syntax
  81. ---------------------
  82.  
  83. MSYM.EXE - Converts .MAP files to .SYM files
  84. --------
  85. Usage: MSYM file_name
  86.  
  87. DLDR.EXE - Loads symbols for DOS programs
  88. --------
  89. Usage: DLDR file-name[.EXE | .SYM]
  90.             .EXE - load .EXE file only (NO SYMBOLS)
  91.             .SYM - load symbol file only
  92.              No extension - Load both program & symbols
  93.  
  94. WLDR.EXE - Loads symbols, source and executables for Windows programs
  95. --------
  96. Does not provide locals and structures support. Obsolete for programs 
  97. built with Microsoft compilers. Only needed for 16-bit Borland.
  98. Usage:
  99. Run WLDR. Enter the name of the program in the dialog box, including the 
  100. file extension. Mark or clear the check boxes to set what to load:
  101. Symbols Only - Check if you don't want to load the executable (i.e. you 
  102. are debugging a DLL or dynamically loaded driver).
  103. No Source - Check if you want to load symbol names but not source code.
  104.  
  105.  
  106.  
  107.  
  108. -----------------------------------------------------------------
  109. Copyright 1996 NuMega Technologies, Inc.
  110. 11/21/96
  111.